home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 June / EnigmA AMIGA RUN 19 (1997)(G.R. Edizioni)(IT)[!][issue 1997-06][EAR-CD III].iso / recent1 / amigat.lha / AmigaT / AmigaT.Doc < prev    next >
Text File  |  1997-05-21  |  14KB  |  323 lines
  1.  
  2.  AmigaT v1.4 © Roger Hågensen of Msi Software 1996-97
  3.  For OS 2.0 (kick 36) or later.
  4.  
  5.  USAGE: AmigaT OPTION VALUE
  6.  
  7.  OPTIONS: CPU, FPU, GFX, KICK, WB, OS, VIDEO, POWER,
  8.           CHIP, FAST, TOTAL, CHIPF, FASTF, TOTALF.
  9.           MAKEDIR, DELETE, RENAME, COPY, CHECK, VERSION, CHECKASN.
  10.  
  11.  CPU VALUES: 68000 = 68000
  12.              68010 = 68010
  13.              68020 = 68020
  14.              68030 = 68030
  15.              68040 = 68040
  16.              68060 = 68060
  17.  
  18.  FPU VALUES: 68881 = 68881
  19.              68882 = 68882
  20.              68040 = 68040 FPU (The 68040 have an internal FPU)
  21.              68060 = 68060 FPU (The 68060 have an internal FPU)
  22.  
  23.  GFX VALUES: OCS = Old Chip Set (A)
  24.              ECS = Enhanced Chip Set (A+)
  25.              AGA = Advanced Graphical Arcitechture (AA)
  26.  
  27.  KICK VALUES:
  28.  If a number like 39 is given as the value,
  29.  then that kickstart version or a higher version will be checked for!
  30.  AmigaT no longer run with kickstarts older than 36.
  31.  Values may range from 0 to 65535.
  32.  Kickstarts: 30 = 1.0
  33.              31 = 1.1
  34.              32 = 1.1
  35.              33 = 1.2
  36.              34 = 1.3
  37.              35 = 1.4
  38.              36 = Kick 2.0b (Early 2.0)
  39.              37 = Kick 2.04 (OS 2.0)
  40.              37 = Kick 2.05 (OS 2.1)
  41.              38 = Kick 2.1  (OS 2.1 Soft)
  42.              39 = Kick 3.0  (OS 3.0)
  43.              40 = Kick 3.1  (OS 3.1)
  44.  
  45.  WB VALUES:
  46.  Same as KICK, but checks Workbench. (software)
  47.  
  48.  OS VALUES:
  49.  Same as KICK. But if Workbench have a higher version than Kickstart,
  50.  then WB version is used as OS version.
  51.  If WB version is older than Kick, then Kick version is used as OS version.
  52.  If WB check fails, then AmigaT will use 0.0 as a FAKE value.
  53.  This way AmigaT will behave correct in the GUI and with the OS option.
  54.  This is to make software updates like OS2.1, to be shown properly.
  55.  Please use the OS option when checking for the version of the system,
  56.  many Kick 2.0 and Kick 3.0 owners have a software upgrade.
  57.  And this OS option is the only way to check the SYSTEM versions,
  58.  the KICK and WB options are for situations where such tests are needed.
  59.  
  60.  VIDEO: PAL  = 50Hz Videomode
  61.         NTSC = 60Hz Videomode
  62.  
  63.  POWER: PAL  = 50Hz Powersupply
  64.         NTSC = 60Hz Powersupply
  65.  
  66.  CHIP: MB number (i.e 2 to check if the Amiga have 2MB chip installed)
  67.  
  68.  FAST: MB number (i.e 8 to check if the Amiga have 8MB fast installed)
  69.  
  70.  TOTAL: MB number (i.e 10 to check if the Amiga have 10MB total installed)
  71.  
  72.  CHIPF: MB number (i.e 1 to check if the Amiga have 1MB chip free)
  73.  
  74.  FASTF: MB number (i.e 4 to check if the Amiga have 4MB fast free)
  75.  
  76.  TOTALF: MB number (i.e 5 to check if the Amiga have 5MB total free)
  77.  
  78.  Note: AmigaT handle tests in a x MB (or more) way, please remember this.
  79.  Important! All MB values can be give as: 1.0 or 2.6 or 4.0 or 8.9 etc.
  80.  This is srongly ADVICED, it is much more accurate ;-)
  81.  
  82.  WARN is returned if not found, or an error was detected!
  83.  0 (NOT WARN) is returned if CPU/FPU/GFX/KICK and is found,
  84.               or when memsize is the same or higher than the given value.
  85.  
  86.  ! as option makes AmigaT act like it was started from WorkBench!
  87.  
  88.  
  89.  Special options:
  90.  
  91.  MAKEDIR followed by a name will create a directory with that name.
  92.  
  93.  DELETE followed by a name will delete a file with that name.
  94.  
  95.  RENAME followed by a name and a second name,
  96.         will rename the file with the first name to the second name.
  97.  
  98.  COPY followed bu a name and a second name,
  99.       will copy the file with the first name to the second name.
  100.  
  101.  VERSION followed by a name will show the version string of that file.
  102.  
  103.  All the special options above will return WARN (5) if failed or error,
  104.  other than that they wil be quiet, and COPY will remove any incomplete
  105.  files. COPY can also be interupted by pressing CTRL-C,
  106.  it will remove any partial file.
  107.  
  108.  If all is ok then NOT WARN (0) is returned.
  109.  
  110.  CHECK followed by a name and a second name,
  111.        will check if first file have a larger version than second file.
  112.        If versions are the same then revisions are checked also.
  113.        If first file (new file to install?) have a higher version/revision
  114.        than the second file (old file) then WARN is returned.
  115.        WARN is also returned if second file was not found,
  116.        or there was an error while checking version info.
  117.        Thus WARN is returned so the install script think an old file
  118.        was found and by that installing over the bogus/corrupted file.
  119.        If second file is same version/revision or newer then NOT WARN is
  120.        returned, thus avoiding replacement of new with old ;-)
  121.  
  122.  CHECKASN followed by a assign/device/volume name,
  123.           will check if that assign exists.
  124.           If not found WARN is returned.
  125.           Important! Do not put : at the end of the name,
  126.           it is not needed and will only confuse AmigaT :-)
  127.           AmigaT will not put up an annoying,
  128.           "Please insert volume blala" requester :-)
  129.  
  130.  Please note the special options are VERY limited.
  131.  No "" can be used to enclose a string thus spaces can not be used
  132.  in filenames, and wildcards like #? can not be used either,
  133.  the COPY option only do a straight forward copy, nothing fancy.
  134.  The CHECK and VERSION options are VERY, VERY, VERY strict.
  135.  So any non standard version string will not be read correctly,
  136.  but if you look at the version string for AmigaT
  137.  Try: "AmigaT VERSION AmigaT" :-)
  138.  As long as the name (no spaces) the version.revsion and (date) are correct,
  139.  AmigaT will do just fine, but some compilers/assemblers tend to put
  140.  version info in a odd way thus AmigaT read the wrong strings (!).
  141.  
  142.  --- Tests! ---
  143.  
  144.  Tested on: A1200, OS3.1, 50MHz 68030 CPU, 50MHz 68882 FPU, 8.0 MB fast.
  145.             A500+, OS3.1, 7MHz 68010 CPU, No FPU, 2.0 MB chip, 2.0 MB fast.
  146.  
  147.  
  148.  --- Info! ---
  149.  
  150.  Some of you have been thinking there is some large errors or AmigaT
  151.  being not 100% correct on it's mem size.
  152.  After improving and going over AmigaT's code,
  153.  I can inform you that it is now 100% correct.
  154.  And please don't yell about memsizes anymore.
  155.  AmigaT when it display 1.0 MB chipram in the GUI,
  156.  it really means 1.0 MB or more, the same for other memory.
  157.  And since v1.3 AmigaT display memory in 100 KB (0.1 MB) steps.
  158.  When the memsize options are used x.x MB is converted to full bytesize,
  159.  thus full byte size is used in math routines.
  160.  AmigaT do not check the REAL memory, only available memory.
  161.  Please also note that some people use ROM-MAPPING,
  162.  thus a 8MB fast Amiga may show up as 7.5MB
  163.  It does so for me (I have Blizzard 1230-IV with ROM-MAPPING).
  164.  
  165.  
  166.  And people please, when using AmigaT in a script.
  167.  Tell AmigaT to look for the absolute MINIMUM you require.
  168.  In other words: "AmigaT FAST 4.0" is the correct way,
  169.  when you want to make shure the machine have 4.0 MB or more mem installed.
  170.  If AmigaT find 4.1 MB free it will say 4.1 MB (or more),
  171.  and if it find 3.9 MB it will NOT say 4.0 MB.
  172.  You may demand a more or less special amount of mem installed,
  173.  like 2.0 MB chip or 4.0 MB fast, but on free memory you must expect
  174.  people to have systems using some more mem than others,
  175.  thus testing for 3.0 MB when 2.9 is requested, will fail,
  176.  if 2.8 is available, thus testing for 2.7 MB (or more) would be
  177.  the correct way but not totally accurate ;-)
  178.  
  179.  --- Future! ---
  180.  
  181.  Damn! This is the last AmigaT so there will be no future things :-(
  182.  
  183.  --- History! ---
  184.  
  185.  v1.0 - First public release, uploaded to Aminet.
  186.  
  187.  v1.1 - Update/bugfix, uploaded to Aminet.
  188.         16bit calc routines used where it should be 32bit routines.
  189.         Thanks to "Daniel Andersson <Daniel.Andersson@abc.se>"
  190.         for reporting this bug, a personalized version is on the way!
  191.         Memory size should now be correct for those with lot's of ram ;-)
  192.         Added options for free memory: CHIPF, FASTF, TOTALF.
  193.         WB bug fixed, it now starts correctly from WB.
  194.         1024 bytes added to installed chipmem size,
  195.         this is because of the "1024 bytes feature".
  196.         (the Amiga stealing the first 1024 bytes, for who knows for what).
  197.  
  198.  v1.2 - Update/bugfix, uploaded to Aminet.
  199.         Memory values are rounded to MB's only when displayed,
  200.         all mem values are handled in FULL size inside AmigaT.
  201.         When asking AmigaT to check for mem, the value given,
  202.         will be multiplied from MB to full bytes size.
  203.         Mem sizes should really be very correct now ;-)
  204.         Full CPU/FPU names must be given, 030 must be 68030 and so on,
  205.         this is for internal reasons, and better looking GUI on FPU info.
  206.         Version check and version.revision for Workbench added.
  207.         Version check and version.revision for OS added.
  208.         If Workbench is higher than kick, then Workbench version is OS.
  209.         Forgot "1024 bytes feature" in the history of the v1.1 document.
  210.         Fixed a options problem, AmigaT believed CHIPF was CHIP etc :-(
  211.         Checked that AmigaT understand the questions (options/calculations),
  212.         there should no longer be any "Programmer was stupid!" bugs ;-)
  213.         Corrected weird things in example script, must have been blind #-(
  214.         Kicked my head a few times because of "Programmer was stupid!" bugs.
  215.         Improved FPU check (FPU is compared with CPU if 68040 or 68060 ;-)
  216.         Got a headache because I kicked myself in the face.
  217.         I'm tired of correcting AmigaT, so if there are no more bugs,
  218.         then send me ideas, tell me how to make AmigaT better ;-)
  219.  
  220.  v1.3 - Update/bugfix, uploaded to Aminet, used by akxxx.datatypes.
  221.         Small bugfix, major update.
  222.         Seems like in the mess with v1.2 i forgot to check the script,
  223.         68040/68060 had not been changed from v1.1, damn!
  224.         Also the OS/WB version option used kick value instead of OS/WB value,
  225.         damn again, also optimized routines, did things differently,
  226.         and thus able to skip certain routines.
  227.         So size haven't changed too much ;-)
  228.         All memsizes are displayed as x.x,
  229.         all memvalues for mem options is entered as x.x, well,
  230.         you can still use x but then again, it's nicer to use x.x ;-)
  231.         So update your scripts.
  232.         I have tried to get the installed mem even more correct,
  233.         this have turned out to be rather difficult, and I hope
  234.         AmigaT has been able to get one of the most accurate
  235.         memsize routines ever made for a tiny util like this.
  236.         Added several special options for Andreas Ralph Kleinert's,
  237.         ak datatypes install script.
  238.         Be shure to check the Msi Software site,
  239.         AmigaT v1.4 is on it's way and will have some improvements,
  240.         most likely on memcheck/versioncheck.
  241.         Some new info may be added also...
  242.  
  243.  v1.4 - Last release!
  244.         Only works with OS 2.0 (Kick 36) or higher.
  245.         Changed memory allocation for COPY option.
  246.         Change my routines, saved some size ;-)
  247.         Fixed a old bug in my version routines,
  248.         more files shuld get their version info read now.
  249.         Fixed the result code from VERSION option.
  250.         040/060 FPU bug fixed,
  251.         thanks to Clay Alberts <clay@umcc.umcc.umich.edu>
  252.         for helping me hunt it down ;-)
  253.         Added special option CHECKASN.
  254.  
  255.  --- Known Bugs! ---
  256.  
  257.  Video & Power frequency.
  258.  This is not a AmigaT bug, but a hardware problem.
  259.  Amiga Technologies say that these two values are very hard to
  260.  keep correct. Currently I have no clue, on how to get around this
  261.  hardware problem and show the correct Hz value in those screenmodes.
  262.  
  263.  Some cpu/ram cards (and the Amiga) tend to steal a little ram,
  264.  so when checking the installed memory it may not be 2.0 MB but slightly
  265.  less, the same may happen to fastmem (i.e ROM-MAPPING etc).
  266.  
  267.  AmigaT v1.3 was developed with the akxxx.datatype install script in mind,
  268.  thus not all of the special options may work so well in other scripts.
  269.  This is not a bug ;-) simply me being a fan of those datatypes and
  270.  thus wanted to make them better (fully automated install script) :-)
  271.  NOTE! ak datatypes no longer use AmigaT but a custom version called akT,
  272.        akT is only used with the ak datatypes and not to be used
  273.        for other purposes, there are some differences between AmigaT & akT
  274.        but the way they work are almost the same.
  275.  
  276.  --- Author! ---
  277.  
  278.  Msi Software
  279.  Roger Hågensen,
  280.  Kolstadflata 35B,
  281.  N-7078 SAUPSTAD,
  282.  Norway.
  283.  
  284.  Phone: (+47) 72 59 07 35.
  285.  Email: "Msi Software <msi@sn.no>"            (Subject: AmigaT v1.4)
  286.    WWW: "http://www.sn.no/~msi/index.htm"
  287.  
  288.  Bugfixes can be found on the WEB page above
  289.  when they become available, and I will try to get them on Aminet also.
  290.  So visit the Msi Galactica site to see if there is new revision
  291.  or important information there.
  292.  
  293.  
  294.  --- Disclaimer! ---
  295.  
  296.  No profit on AmigaT is allowed!
  297.  No disassembling/reverse-enginering is allowed!
  298.  No changes to the distribution archive is allowed!
  299.  I take no responsability if anything goes wrong,
  300.  if AmigaT damage your hardware/software I can not be held responsible!
  301.  AmigaT has been tested, but no claims on it's functionality!
  302.  
  303.  
  304.  --- Copyrights! ---
  305.  
  306.  AmigaT is copyright 1996-1997 Msi Software!
  307.  AmigaT is Freeware, and Freely Distributable!
  308.  For commercial usage contact Msi Software!
  309.  For coverdisk/shareware/licenseware/semi-commercial usage,
  310.  send a FREE REGISTERED copy of the (magazine & disk),
  311.  the distribution or product to the AUTHOR of AmigaT!
  312.  
  313.  --- Special License! ---
  314.  
  315.  The author of the akGIF/akJFIF/akPNG and akSVG datatypes
  316.  have my special permission to use AmigaT (any version),
  317.  for his freeware/shareware and commercial software.
  318.  Although a free copy of software using AmigaT would be nice,
  319.  it is not requiered, he will also get as much support as I can give.
  320.  Also, akT the custom version of AmigaT is only to be used with
  321.  the ak datatypes, and Mr. Kleinert holds the distribution rights
  322.  to akT so if you wish to use akT then ask HIM...
  323.